home *** CD-ROM | disk | FTP | other *** search
/ MacUser Mac Bin 28 / MACUSER-MACBIN28A-1996-03.ISO.7z / MACUSER-MACBIN28A-1996-03.ISO / Demo / MachTen 4.0.2 Demo / X Window Software / X11R5 / man / mann / xpr.0 < prev    next >
Text File  |  1995-08-14  |  13KB  |  325 lines
  1. NAME
  2.        xpr - print an X window dump
  3.  
  4. SYNOPSIS
  5.        xpr  [ -device devtype ] [ -scale scale ] [ -height inches
  6.        ] [ -width inches ] [ -left inches ] [  -top  inches  ]  [
  7.        -header  string  ]  [  -trailer  string ] [ -landscape ] [
  8.        -portrait ] [ -plane number ] [ -gray ] [ -rv ] [ -compact
  9.        ]  [  -output  filename ] [ -append filename ] [ -noff ] [
  10.        -split n ] [ -psfig ] [ -density dpi ] [ -cutoff level ] [
  11.        -noposition  ] [ -gamma correction ] [ -render algorithm ]
  12.        [ -slide ] [ filename ]
  13.  
  14. DESCRIPTION
  15.        xpr takes as input a window dump file produced  by  xwd(1)
  16.        and formats it for output on PostScript printers, the Dig-
  17.        ital LN03 or LA100, the IBM PP3812 page  printer,  the  HP
  18.        LaserJet  (or other PCL printers), or the HP PaintJet.  If
  19.        no file argument is given, the standard input is used.  By
  20.        default, xpr prints the largest possible representation of
  21.        the window on the output page.  Options allow the user  to
  22.        add  headers  and  trailers,  specify  margins, adjust the
  23.        scale and orientation, and append multiple window dumps to
  24.        a single output file.  Output is to standard output unless
  25.        -output is specified.
  26.  
  27.        Command Options
  28.  
  29.  
  30.        -device devtype
  31.               Specifies the device on  which  the  file  will  be
  32.               printed.  Currently supported:
  33.                    la100  Digital LA100
  34.                    ljet   HP LaserJet series and other monochrome
  35.                           PCL devices such as ThinkJet, QuietJet,
  36.                           RuggedWriter, HP2560 series, and HP2930
  37.                           series printers
  38.                    ln03   Digital LN03
  39.                    pjet   HP PaintJet (color mode)
  40.                    pjetxl HP  HP  PaintJet  XL   Color   Graphics
  41.                           Printer (color mode)
  42.                    pp     IBM PP3812
  43.                    ps     PostScript printer
  44.  
  45.               The  default  is  PostScript.   -device  lw (Laser-
  46.               Writer) is equivalent to -device ps and is provided
  47.               only for backwards compatibility.
  48.  
  49.        -scale scale
  50.               Affects  the  size  of the window on the page.  The
  51.               PostScript, LN03,  and  HP  printers  are  able  to
  52.               translate  each  bit  in  a window pixel map into a
  53.               grid of a specified size.   For  example  each  bit
  54.               might  translate  into  a  3x3 grid.  This would be
  55.               specified by -scale 3.   By  default  a  window  is
  56.               printed  with  the largest scale that will fit onto
  57.               the page for the specified orientation.
  58.  
  59.        -height inches
  60.               Specifies the maximum height of the page.
  61.  
  62.        -width inches
  63.               Specifies the maximum width of the page.
  64.  
  65.        -left inches
  66.               Specifies the left margin in inches.  Fractions are
  67.               allowed.   By default the window is centered in the
  68.               page.
  69.  
  70.        -top inches
  71.               Specifies the top margin for the picture in inches.
  72.               Fractions are allowed.
  73.  
  74.        -header string
  75.               Specifies  a  header string to be printed above the
  76.               window.
  77.  
  78.        -trailer string
  79.               Specifies a trailer string to be printed below  the
  80.               window.
  81.  
  82.        -landscape
  83.               Forces the window to printed in landscape mode.  By
  84.               default a window is printed such that  its  longest
  85.               side follows the long side of the paper.
  86.  
  87.        -plane number
  88.               Specifies  which bit plane to use in an image.  The
  89.               default is to use the entire image and  map  values
  90.               into black and white based on color intensities.
  91.  
  92.        -gray  2 | 3 | 4
  93.               Uses  a  simple 2x2, 3x3, or 4x4 gray scale conver-
  94.               sion on a  color  image,  rather  than  mapping  to
  95.               strictly  black  and white.  This doubles, triples,
  96.               or quadruples the effective width and height of the
  97.               image.
  98.  
  99.        -portrait
  100.               Forces  the  window to be printed in portrait mode.
  101.               By default  a  window  is  printed  such  that  its
  102.               longest side follows the long side of the paper.
  103.  
  104.        -rv    Forces the window to be printed in reverse video.
  105.  
  106.        -compact
  107.               Uses  simple run-length encoding for compact repre-
  108.               sentation of windows with lots of white pixels.
  109.  
  110.        -output filename
  111.               Specifies an output file name.  If this  option  is
  112.               not specified, standard output is used.
  113.  
  114.        -append filename
  115.               Specifies  a filename previously produced by xpr to
  116.               which the window is to be appended.
  117.  
  118.        -noff  When specified in  conjunction  with  -append,  the
  119.               window will appear on the same page as the previous
  120.               window.
  121.  
  122.        -split n
  123.               This option allows the user to split a window  onto
  124.               several  pages.   This  might be necessary for very
  125.               large  windows  that  would  otherwise  cause   the
  126.               printer  to  overload  and  print  the  page  in an
  127.               obscure manner.
  128.  
  129.        -psfig Suppress translation of the PostScript  picture  to
  130.               the center of the page.
  131.  
  132.        -density dpi
  133.               Indicates  what dot-per-inch density should be used
  134.               by the HP printer.
  135.  
  136.        -cutoff level
  137.               Changes the intensity level where colors are mapped
  138.               to either black or white for monochrome output on a
  139.               LaserJet printer.  The level is expressed  as  per-
  140.               centage of full brightness.  Fractions are allowed.
  141.  
  142.        -noposition
  143.               This option causes header, trailer, and image posi-
  144.               tioning  command  generation  to  be  bypassed  for
  145.               LaserJet, PaintJet and PaintJet XL printers.
  146.  
  147.        -gamma correction
  148.               This changes the intensity of the colors printed by
  149.               PaintJet  XL  printer. The correction is a floating
  150.               point value in the range 0.00 to 3.00.  Consult the
  151.               operator's  manual  to  determine the correct value
  152.               for the specific printer.
  153.  
  154.        -render algorithm
  155.               This allows PaintJet XL printer to render the image
  156.               with  the best quality versus performance tradeoff.
  157.               Consult the operator's manual  to  determine  which
  158.               algorithms are available.
  159.  
  160.        -slide This  option  allows  overhead transparencies to be
  161.               printed using the PaintJet and PaintJet  XL  print-
  162.               ers.
  163.  
  164.  
  165. SEE ALSO
  166.        xwd(1), xwud(1), X(1)
  167.  
  168. LIMITATIONS
  169.        The  current version of xpr can generally print out on the
  170.        LN03 most X windows that are not larger than two-thirds of
  171.        the  screen.   For example, it will be able to print out a
  172.        large Emacs window, but it will usually fail  when  trying
  173.        to print out the entire screen.  The LN03 has memory limi-
  174.        tations that can cause it to incorrectly print very  large
  175.        or  complex  windows.   The two most common errors encoun-
  176.        tered  are  "band  too  complex"   and   "page   memory
  177.        exceeded."   In  the first case, a window may have a par-
  178.        ticular six pixel row that contains too many changes (from
  179.        black  to white to black).  This will cause the printer to
  180.        drop part of the line and possibly parts of  the  rest  of
  181.        the  page.   The  printer will flash the number `1' on its
  182.        front panel when this problem occurs.  A possible solution
  183.        to  this  problem is to increase the scale of the picture,
  184.        or to split the picture onto two or more pages.  The  sec-
  185.        ond  problem,  "page memory exceeded," will occur if the
  186.        picture contains too much black, or if  the  picture  con-
  187.        tains complex half-tones such as the background color of a
  188.        display.  When this problem occurs the printer will  auto-
  189.        matically  split  the  picture into two or more pages.  It
  190.        may flash the number `5' on its from panel.  There  is  no
  191.        easy solution to this problem.  It will probably be neces-
  192.        sary to either cut and paste, or to rework the application
  193.        to produce a less complex picture.
  194.  
  195.        There  are  several  limitations on the LA100 support: the
  196.        picture will always be printed in portrait mode, there  is
  197.        no scaling, and the aspect ratio will be slightly off.
  198.  
  199.        Support  for PostScript output currently cannot handle the
  200.        -append, -noff or -split options.
  201.  
  202.        The -compact option is only supported for PostScript  out-
  203.        put.  It compresses white space but not black space, so it
  204.        is not useful for reverse-video windows.
  205.  
  206.        For color images, should map directly to PostScript  image
  207.        support.
  208.  
  209.  
  210. HP PRINTERS
  211.        If  no  -density is specified on the command line 300 dots
  212.        per inch will be assumed for ljet and 90 dots per inch for
  213.        pjet.  Allowable density values for a LaserJet printer are
  214.        300, 150, 100, and 75 dots per inch.  Consult  the  opera-
  215.        tor's  manual  to  determine  densities supported by other
  216.        printers.
  217.  
  218.        If no -scale is specified the image will  be  expanded  to
  219.        fit the printable page area.
  220.  
  221.        The  default  printable  page area is 8x10.5 inches. Other
  222.        paper sizes can be  accommodated  using  the  -height  and
  223.        -width options.
  224.  
  225.        Note that a 1024x768 image fits the default printable area
  226.        when processed at 100 dpi with scale=1, the same image can
  227.        also  be  printed  using  300  dpi  with  scale=3 but will
  228.        require considerably  more  data  be  transferred  to  the
  229.        printer.
  230.  
  231.        xpr  may  be tailored for use with monochrome PCL printers
  232.        other than the LaserJet.  To print on a ThinkJet (HP2225A)
  233.        xpr could be invoked as:
  234.  
  235.            xpr -density 96 -width 6.667 filename
  236.  
  237.        or for black-and-white output to a PaintJet:
  238.  
  239.            xpr -density 180 filename
  240.  
  241.        The  monochrome intensity of a pixel is computed as 0.30*R
  242.        + 0.59*G + 0.11*B.  If a  pixel's  computed  intensity  is
  243.        less  than the -cutoff level it will print as white.  This
  244.        maps light-on-dark display images to black-on-white  hard-
  245.        copy.  The default cutoff intensity is 50% of full bright-
  246.        ness.   Example:  specifying  -cutoff   87.5   moves   the
  247.        white/black intensity point to 87.5% of full brightness.
  248.  
  249.        A LaserJet printer must be configured with sufficient mem-
  250.        ory to handle the image.  For a full page at 300 dots  per
  251.        inch approximately 2MB of printer memory is required.
  252.  
  253.        Color  images  are produced on the PaintJet at 90 dots per
  254.        inch.  The PaintJet is limited to sixteen colors from  its
  255.        330 color palette on each horizontal print line.  xpr will
  256.        issue a warning message if more than  sixteen  colors  are
  257.        encountered  on a line.  xpr will program the PaintJet for
  258.        the first sixteen colors encountered on each line and  use
  259.        the  nearest  matching  programmed  value for other colors
  260.        present on the line.
  261.  
  262.        Specifying the -rv, reverse video, option for the PaintJet
  263.        will  cause black and white to be interchanged on the out-
  264.        put image.  No other colors are changed.
  265.  
  266.        Multiplane images must be recorded by xwd in ZPixmap  for-
  267.        mat.   Single  plane  (monochrome) images may be in either
  268.        XYPixmap or ZPixmap format.
  269.  
  270.        Some PCL printers do not recognize image positioning  com-
  271.        mands.   Output for these printers will not be centered on
  272.        the page and header and trailer  strings  may  not  appear
  273.        where expected.
  274.  
  275.        The  -gamma  and -render options are supported only on the
  276.        PaintJet XL printers.
  277.  
  278.        The -slide option is not supported for LaserJet  printers.
  279.  
  280.        The -split option is not supported for HP printers.
  281.  
  282.        The  -gray option is not supported for HP or IBM printers.
  283.  
  284. COPYRIGHT
  285.        Copyright 1988, Massachusetts Institute of Technology.
  286.        Copyright 1986, Marvin Solomon and the University of  Wis-
  287.        consin.
  288.        Copyright 1988, Hewlett Packard Company.
  289.        See X(1) for a full statement of rights and permissions.
  290.  
  291. AUTHORS
  292.        Michael  R. Gretzinger, MIT Project Athena, Jose Capo, MIT
  293.        Project Athena (PP3812 support), Marvin  Solomon,  Univer-
  294.        sity  of Wisconsin, Bob Scheifler, MIT, Angela Bock and E.
  295.        Mike Durbin, Rich Inc. (grayscale),  Larry  Rupp,  HP  (HP
  296.        printer support).
  297.  
  298. X Version 11                Release 5                           5
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.